

   WELCOME
----------

Welcome to the Windows 95 distribution of Clean 1.3.2 which includes the
0.8.1 version of the Clean I/O library.

This release runs on Windows 95 and Windows NT 4.0. (Windows 3.1 will not be
supported, not even with Win32s).

This zip file contains

-  The Clean compiler  (cocl.exe and cg.exe), which is called from
-  The Clean Integrated Development Environment (CleanIDE.exe) with
   its help file ('Clean Help') and preferences file ('CleanPrefs').
-  The standard library for arthmetic, string and list manipulation,
   file I/O, etc. (StdEnv)
-  The I/O library for graphical user interface applications
   (IOInterface). Note that there are some small differences between the 
   Windows 95 version and the Macintosh version of the I/O library. 
   See below.
-  The profile application 'ShowProfile.exe'
-  Registry utilities
-  Several example programs, including examples of graphical user
   interfaces (Small Demos & IOExamples).
 
   CHANGES FROM VERSION 1.3.1 TO 1.3.2
--------------------------------------

 - A new link facility has been added to Clean 1.3.2. It
   is now possible to specifiy within an icl file, which object files
   and libraries have to be linked. Link Problems will occur when Clean 1.3.2
   is used with old I/O libraries, or when an old CleanIDE/compiler is
   used with new I/O libraries. So don't confuse these versions. Use 
   Clean 1.3.2 with the following libraries:
	- the StdEnv contained in this package
   	- the Object I/O library version 1.1
   	- the IOInterface 0.8.1
   	- the TCP libraries 1.1
   For older versions of these libraries use an older Clean version.

   To specify in an icl which object files or libraries have to be
   linked write for example the following:
     
     import code from "objectFileName", library "libraryFileName"

 - the IOInterface contains two new modules which offer a printing
   facility (deltaPrint and deltaPrintText).

   INSTALLATION
---------------

Installation should be simple:

-  Unzip 'Clean132.zip' to any destination you like.
   Be sure to use an unzipper program that understands long
   file names. Also, extract the files WITH the directory
   structure intact.  
   This will create a 'Clean 1.3.2' folder.

-  In the 'Clean' folder find, and execute the program 'change_registry.exe'
   This will associate the Clean files (.icl, .dcl and .abc) with the CleanIde
   and profile files (.pcl) with the ShowProfile application.

-  In the 'Clean' folder find, and execute the program 'CleanIDE'.
   This starts the special Clean development environment.

   COMPILING I/O EXAMPLES
-------------------------

Now you can try to compile one of the example programs.

-  From within the IDE, use the 'Open...' item in the 'File' menu
   to open 'Mines.icl'. You can find Mines in the IOExamples 
   directory. 'Mines.icl' is the top-most implementation module
   of the Mines example.

-  Make a project out of 'Mines' by selecting 'New Project' from the 
   Project menu. This creates a new file 'Mines.prj' that you can 
   use later on to open the project and all associated files.

-  By default, Clean applications create a console window (kinda like the 
   MS-DOS window) for their output. Since Mines is a GUI program which
   creates its own windows, you don't want a console for Mines. Disable
   the console creation by selecting "Application..." from the Options
   menu and selecting the "No Console" radio button in the dialog that
   appears. 

-  From the 'Commands' menu, select 'Run "Mines"'. The IDE will now
   build the application. It will launch 'mines.exe' automatically.

-  Have fun. Be sure to report any bugs you find via email to
   clean@cs.kun.nl

Use the same procedure to compile all other IO example programs. 
You can recognize the top-level implementation module by the fact that
it doesn't have a corresponding '.dcl' file.



   DIFFERENCES BETWEEN THE WINDOWS AND MACINTOSH VERSION OF THE I/O LIB
-----------------------------------------------------------------------

1.  Of the nine pen modes defined in deltaPicture only CopyMode, XorMode
    and HiliteMode are implemented in the Windows 95 version of the I/O
    library.

2.  Pen patterns are not implemented in the Windows 95 version of the I/O
    library.

3.  The function NestIO in deltaEventIO does not exist in the windows 95
    version of the I/O library

4.  The functions SelectInputFile and SelectOutputFile (from 
    deltaFileSelect) have had their types changed. Instead of requiring
    and returning a 'Files' parameter, they now require and return the
    program state. This is also true in the latest version of the
    Macintosh I/O library.

5.  The function OpenNotice now requires and returns an additional
    parameter: the program state. This is also true in the latest version
    of the Macintosh I/O library.



   ONLINE HELP AND DOCUMENTATION
--------------------------------

The Clean System application contains an on-line help facility, which
will give you more information about Concurrent Clean and the Clean
System.

Documentation can be found in the directory

        ftp://ftp.cs.kun.nl/pub/Clean/Clean13/doc

There is a mailing list for discussions about Clean.  Send mail to
"clean-request@cs.kun.nl" with the word "subscribe" in the Subject: field
to join this mailing list.

We also have some pages on the World Wide Web, with documentation, manuals,
papers and versions of Clean for other platforms:

        http://www.cs.kun.nl/~clean/



   PLEASE REPORT BUGS
---------------------


If you find any bugs, have questions, comments or suggestions you can
reach us at:

        clean@cs.kun.nl

